Translates a document from one format to another.

OSErr TranslateFile (
    const FSSpec *sourceDocument, 
    const FSSpec *destinationDocument, 
    const FileTranslationSpec *howToTranslate
);

Parameter descriptions

sourceDocument

A pointer to the document to translate.

destinationDocument

A pointer to the file to put the translated document into. Note that your application only specifies the name and location for the file; the function creates the file and puts the translated data into it. The destination file must not exist before you call this function.

howToTranslate

A pointer to a buffer of information indicating how to translate the document. Usually, you’ll get this information by calling the CanDocBeOpened function.

function result

A result code.

SPECIAL CONSIDERATIONS

This function might cause memory to be moved or purged; you should not call it at interrupt time.

AVAILABILITY

Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.

© 2000 Apple Computer, Inc. (Last Updated 6/30/2000)